Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 3 - Text Encoding Converter Reference / Text Encoding Converter Functions

Multiple Encoding Run Conversions /

TECCreateOneToManyConverter

Creates a converter object that can handle conversion from one source encoding to multiple destination encodings.

pascal OSStatus TECCreateOneToManyConverter(
                     TECObjectRef *newEncodingConverter, 
                     TextEncoding inputEncoding, 
                     ItemCount numOutputEncodings, 
                     const TextEncoding outputEncodings[]);

newEncodingConverter

A pointer to a converter object. On return this points to the newly created one-to-many converter object.

inputEncoding

The text encoding specification for the source text encoding.

numOutputEncodings

The number of text encoding specifications in the outputEncoding array.

outputEncodings[]

An ordered array of text encoding specifications for the destination text encodings.

function result

A result code. See "Text Encoding Conversion Manager Result Codes" (page 42) for a list of possible values. If this function returns a result code other than NoErr, then it did not successfully create the converter object reference. If the current configuration of the converter does not support the source encoding or any of the destination encodings, the function returns KTextUnsupportedEncodingErr.

DISCUSSION

The TECCreateOneToManyConverter function determines a conversion path for the source encoding and destinations encodings you specify, creates a text encoding converter object, and returns a reference to it. You use this converter object reference with conversion functions such as TECConvertTextToMultipleEncodings (page 101). This converter object describes the source, destination, and intermediate encodings; state information; and references to required plug-ins.

To remove a converter object, you must call the function TECDisposeConverter (page 93).

SEE ALSO

The function TECFlushText (page 97)